
INDEPENDENT GAMES 


-SUMMIT- 


Making Your Own Tools 
& Hidden Benefits 


Omar Cornut 

Programmer, Lizardcube (Paris) 


GDC 


GAME DEVELOPERS CONFERENCE March 14-18, 2016 ■ Expo: March 16-18, 2016 #G0C16 




Soul Bubbles Pixeljunk Shooter Tearaway 



- Bottom-up game designs, building everything as we go 

- Custom tools, always evolving specs 
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"dear imgui" 

- Free software C++ library 

- UI toolkit aimed at games 
developers 

- Self-contained (9 files!) 

- Portable 



▼ ImGuiTest 
Menu Examples 

3 Metrics 
9 Main menu bar 
9 Console 
j Simple layout 

Long text display 

I Auto-resizing window 

A PP* e Simple overlay 
Banana Manipulating window title 
Cherry Custom rendering 

Kiwi 

Mancn 

► Range Widgets 

► Multi-component Widgets 

► Vertical Sliders 

▼ Graphs widgets 


Sources at http://www.aithub.com/ocornut/imaui 
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Why do we need our own tools? 


- Most ready-made engines are focused on 
authoring "startup conditions", rather than 
authoring and understanding running systems 

- Too much focus on level-design! 

- We need more tools for game-design! 
(PuzzleScript <3) 

- We need more tools for debugging 
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Tools to make sense of the mess 


- Games = "interactive haystacks" 

- Nobody in the team understands everything 
about how the game works 

- Make it easier to visualize your game logic 
and game data! Share that knowledge! 
Solve problems faster 
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dear imgui: goals 


- Easy to use: turn making Ul/tools into 
habit rather than an afterthought 

- Low friction for quick use/hacking 

- Create tools that are always available 
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Always Available tools 


- Embed tools inside engine/game 

- Have access to all engine/game state 

- Understand problems as they happens 

- You can ship tools to everyone 

- Programmers, Designers, Artists, QA, etc. 

- Players, modders? 
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Brigador © Stellar Jockeys 


Main | Mech debug | Pack file | Data editor | Message debug | Range 


sound_radi us 


height 

hover_hei ght 


▼ Guns 


Laser, 12W Discharge. 'Broiler' 

Cooldown remaining: 1.451185 

Adj. accuracy cone: 8.104720 (6.000000 degrees) 
BPS: 8.571429 
DPS: 17.142859 
Shots per burst: 30 


assets/data/weapons/corv_l aser_tur_81. json 


AI state 


Leg FSM: LegMove 

Chassis FSM: Chassi sShootAt 

AI index: 66 


► transition table 
Current target 


Custom target 


Handle 

type 


Handle 

type 


count = 1 
ptr = 28F3DAB8 
Last known position: 

vec2 : (193.431030, 253.716141) 

timestamp: 28.217361 

Valid 


count = -1 
ptr = 00000000 
Last known position: 

Vec2 : (0.000000, 0,000000) 

timestamp: 8.000000 


Set Toqqle valid Zero 

Last known velocity: 

Vec2 : (0.000000, 0.000000) 
timestamp: 8,000000 


Last known velocity: 
vec2 : (0.000000, 0.000000) 
timestamp: 28.217361 
Valid 


▼ Game object query 


Num queryabl e : 14632 / 32768 
Num passed filter: 11960 / 14632 
Num failed filter: 2672 / 14632 


Set Toqcfle valid [2£ro! 

Last known orientation: 

Vec2: (0.000000, 0.000000) 
timestamp: 0.000000 


Last known orientation: 

vec2 : (-8.912526, -0.409019) 
timestamp: 28.217361 
Valid 


Last known height: 2.963000 
Last known radius: 8.900800 
Priority: 1 (AGGRO_MECH) 
Have LoS 


Last known height 
Last known radius 


AGGRO_LOWEST 


Conti 


▼ Player Mech 


Select player Respawn 


Mech : assets/data/uni ts/pl ayer/corv_tanl 


assets/data/abi 1 i ti es/speci al_si lentrun. j: 


BEHAVI OR_NORMAL 


NORMAL_GOTO_F I RI NG_POSITI ON 

▼ 
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dear imgui: usage 


- Your code creates live UI every frame 

- Pull, display or edit data straight from 
your engine/game 

- Perfect for creating real-time interactive 
visualization/debugging tools 
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Code example 


ImGui: :DragFloat("MaxSpeed", &MaxSpeed); 


A wild interactive widget appears! 




▼ Debug 

2.000 

MaxSpeed 




Interact/process immediately 
It works from anywhere in 
your code 
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140 


master hue 

H:140 

S:1 80 

V:1 61 

P main 

H:140 

S:1 24 

V:100 

area 

H:140 

L 

S: 59 

V:40 

back 

j 


▼ Example: Property editor 

(?) 

► Object_0 

my sailor is rich 

T ObjectJ 

my sailor is rich 

► Child.3700257420 

my sailor is rich 

► Child.2063235384 

my sailor is rich 

Field.2 

1.000 

Field_3 

3.142 

Field_4 

100.000 

Field.S 

999.000000 - + 

Field.6 

0.000000 - + 

Field_7 

0.000000 - + 

► Object_2 

my sailor is rich 
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R:255 G: 0 

R:102 G:178 

Apple 
Banana 
Cherry 
Kiwi 

Manon 

► Range Widgets 

► Multi-component Widgets 

► Vertical Sliders 

▼ Graphs widgets 


B: 0 



Sin 


func 


70 


color 1 (?) 
color 2 
listbox 

(single select) 


-■ml 


Frame Times 

Lines 

pause 

Histogram 


Sample count 
Lines 


Histogram 
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Hidden Benefit: Tools = Communication 


- Exposing data/algorithms is de-facto 
communication within team 

- Avoid game being a black box to 
designers, artists, QA 

- Tame complexity, understand what's 
going on! 
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boxes 


▼ Quadtree 


■ Display Static Instances 
Display Dynamic Instances 

■ Di splay Camera 
Display Active Zone 
Display Node Updates 


Bounding Boxes 


Center F i t 
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Plot spatial data 


// Draw LOD mini -map 
// (also: abstract painting) 
draw a rectangle 
for all objects 
{ 

transform coordinates 
choose a color 
draw a circle 

} 
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Budget viewer 
Red only 

DrawDatabase 
Drawc calls 

Stati cGrp 


F i 1 ter 


574/frame (max 15GG) 
3G9 (max 5GG) 


38 % 

137 % 

82 % 

61 % 

88 % ~ 

119 % 
271 X 



<— Monitor stats, 
budgets 
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Hidden Benefit: Tools = Documentation 


- Interactive tool = Self-documenting 
software. 

- Always up to date. 

- Write new code & matching tool together! 

- Easier to debug, now and later. 

- Helps to communicates terminology. 

- Everybody can speak the same language. 
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Kiss it simple 


- Tools don't have to be amazing, they 
just need to serve a purpose: 

- Make your life easier / happier 

- Make your game better 

- They don't have to last a life-time 

- They don't have to be pretty 
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Common Excuses 


- "We don't have time to make tools" 

- Implies that tools are a luxury or a 
productivity loss. They aren't! 

- "I am terrible at it / I hate UI stuff" 

- Try different ways of doing it ("dear imgui" 
one way but there are many others) 

- The more you'll do it, the better you'll get! 
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A few examples 
of simple, custom tools 
using dear imgui 
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S U M M I T 
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<- Mini 

Searching Tool 

(20 lines 
of code) 

(live search for 
objects, display 
results in a list, 
display preview in 
mini-map) 


T Texture 
Options 


Name 

Texture 0X004B22A0 
OK 0xe51bld£ Texture 0XO04B24D0 

OK 0x7dea0fc tex/LocDesert/sky.png 


:atu Resource]! 


0xldc848£| 


OK 0xc73c59] tex/LocDesert/clouds03.png 

ok ^xebee33i tex/LocDesert/pyramid01.png ^ 

OK 0x61bl20t tex/LocDesert/smokeOl . png 

OK 0x631ecf1 tex/LocDesert/ground03 . png 

OK 0xbb7c88G tex/LocDesert/buildings . png 

OK 0x630cb7"; tex/LocDesert/ground02 . png 

OK 0xec0O4bc tex/LocDesert/pyramid02 . png 

OK 0x268142c tex/LocDesert/door_desert . png 

OK 0xc72a401 tex/LocDesert/clouds02 . png 

OK 0x8bc80b1 tex/blocks . png 

OK 0x2048466 tex/UI/UI_01 . png 

30 Resources total. Total Memory: 57.75 MB 
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▼ JobMgr : :WorkerThr 
698 markers 
per frame 


Updc Upda UpdateDynNi* ,|upd<Upd , . . UpdateDi. 

Mill P_ | P_DEFP_C3 P_ P_ llll P_DEFEF 


Physi cStep 

Simulation wri teP Af terfj 

Broadphase CollCor| 


▼ JobMgr : iWorkerThre 
503 markers 
per frame 


UpcUpdat Update Upda. . . . Up Upd.Up( . . . Up UpdateDynN. 

P_. P_||PJP_<| PJ HI | |p_CP_CSM0 | 
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Tearaway 


▼ Wor 1 d Contents 


Debug Object 


Log To TTY Log To File Log To Clipboard 


Log To TTY Log To File Log To Clipboard 2 Depth 

▼ Options 

DrawDebug Q.Q Tint 0.| LayoutAlpha 
■ Se 1 ec tSensors fl| AnimDetails | GroundDebug J| Paper Level OBB 
Debug Object ID 

* Events 

On selected event: ^ Break Pause 

^ None AddToWorld RemoveFromWor 1 d 

( I Star tPl ay i ng De 1 e teReques t 

) Si eep WakeUp 

' UpdateAi UpdateGnd 

LogicOutput Logiclnput 

I OnContact OnTrajChange 

v Tools 


World Coni 


► Objects (3525) 


► Ob j ectsCharac ters (69) 


► Ob j ectsToRender (711) 


0X100 


Awake Ob jec tsL i s t (718) 


► 2 AIHint 

► 1 BabyWendigo 

► 8 CameraHint 

► 1 Crow 


Once 


Delete 

Update 

Render 


1 CustomTarget 

10 Di gi tal Bu t tonDe tec tor 
^E 1 e p h a n t 
44 FixedProp 
270 FoldingProp 

2 GodRaySource 
15 Gopher 

6 Instance Object 
1 Level CheckPoi nt 


OnDamaged 

Custom 


WakeUpO SleepO Acti vateRi gi dBody( ) Kill CheckWor 1 dSl eepBudd i es 
Offset from player: ( 0 . 00 , 0 . 00, 0 . 00 ) Distance: 0.00 


* Level CheckPoi nt ( 1 eve 1 _check_po i n t . prop ) a 
Select Locate Print Print ID Delete 

► PaperLevel : 1 eve 1 _s tar t_po i nt. 1 vl 0x211 

► FixedProp (fixed, prop) at (55. 70, 0, 00, 2i 
Id: Oxab0b805c09ba21e3, Ptr: 225f811c0 
Data: 1 evel_check_poi nt, prop 

Pos: (19.94,2.08,206,16), Com: (19,94,2.08 
Aabb : (19.93,2.11,206.14) hw (0.82,0.11,0. 
Streami ngP 1 ace I d : 45 

FAILED to stick to 0x89e5d4all9f f lb7c 
Col 1 i si onFi 1 ter Group 0002, Mask FFFFFFFF 
1 Leve 1 Star tPo i n t 


Locate Print Print ID Delete 

► RigidBody: 0x20a6al2a0 

► FoldingProp ( f 0 1 d i ng_prop . prop ) at (-25.81,21.65,237.52) 

► Gr oundShee t : 0x2059d0c50 Default 

► AIHint at (-21.00,23.39, 236.19) 'AI. 

► AnimLibrary (131) 


i ota 


Id: 0x100, Ptr: 218d98060 

Data: papercraf t p 1 ayer. mon ('Atoi') 

Name: 'ThePlayer' 

Pos: (-21.03,23.39,236.21), Com: (-21.03,23.39,236.21), Upness : 
Aabb: (-21.06,24.58,236.22) hw (1.09, 1.26,1.07) 

Str eami ngP 1 ace I d : 42 

AngularVel: (0.00,-0.00,0.00) (=0.00) 

Col 1 i si onFi 1 ter Group 0008, Mask FFFFDF7F 
Ground: Default (Obj : 21bd3dlb0, Sht: 2059d0c50) 
GroundContactNormal : (-0.03,1.00,0.01) (= 1,00) ( do t . up=0 . 999 ) 
GroundSurf aceNormal : (-6.03,1.00,0.01) (= 1.00) ( do t . up=0 . 999 ) 
GroundPos: (-21.02, 23.39,236.21), 1 eng th ( Gr oundPos-Com) : 0.006 

Nex tGroundPhy : Default (Obj: 21bd3dlb0, Sht: 2059d0c50) 
NextGroundPos : (-21.03,23.39,236.21), 1 ength(NextGroundPos-Com) 

I d 1 eBehav i our : Wander, F 1 eeBehav i our : Flee 
Invi nci bl eForCutsceneAny : true 
IsPl ayer InputsEnabl ed : false 


► 12 LightProp 

► 86 LogicBlock 

► 1 Monkey 

► 6 MovingBlock 

► 1 NPC 

► 1 PaperCraf tPl ayer 

► 168 Par t i c 1 eEmi t ter 

► 1 Prop 

► 25 Rumbl eControl 1 er 

► 11 Speci al Effect 

► 5 ThemeBl endCon tro 1 1 er 

► 6 VitaButtonBlock 

► 28 WindDetector 

► 4 Yell owF i nger 


Model: i 0 ta_a to i _mesh . GR2 
Anim Controls: 1 

- #0: 1.00 Wave ' i 0 ta_i d 1 e_wave_a t_p 1 ayer_an i m. GR2 1 [ t i me : 1 . 914/2 . 667, sp:1.00 e' 
(user_w: 1. 00 , io_w:l.O0, ou t_speed : 0 , 00 , i n_t i me : 0 . 25s, loopidx: 0->0, pri:113. 


AI Hi n tSta te 

TheHint: 206e34c70 ( 3c09e35850e28908 ) 'AI_iota 
SubState: Animate 

TaskMove: State:Stop, Finished:!, Success:! 


► AwakeOb j ec tsL i st (By Update Order) (718) 


► NeverSl eepOb j ec tsL i s t (9) 


► Memory 




■ Lumix Studio - universes/player, unv 

File Edit Entity Tools View 


Properties 




Remove component 

models/creatures/deer/deerl.msh 

J [. . -] [view] Source 

▼ Materials 

models/creatures/deer/eye. mat 

(...) (view) Material 

models/creatures/deer/antlers .mat 

(...) (View| Material 

models/creatures/deer/head.mat 

1...] (view| Material 

models/c reatures/deer/body . mat 

) . .] (view) Material 

▼ Lua script 

Remove component 


1 Add script | 


▼ player 

Remove script. 

scripts/player. lua 

| [^.J (View) Source 

1.000 

M0USE_ SENSITIVITY 

0.100 

PLAYER SPEED 

•1 

[. . .) camera entity 

dest 

[. . .) dest entity 

navmesh 


(91 Debug 


Navigate] 



▼ Asset Browser Entity List x 


New group name 

1 Create g roup 


▼ default (14) 

editor camera Entities 

I - cube 
global light 
deer • deerl 
6 - cube 
dest 

4 - cube 
3 • cube 

5 - cube 

9 - cube 

10 ■ cube 

II - cube 

12 - cube 

13 • cube 


I 


Can not delete • at least one group must exists 
I Selec t all entities in gro up 
Assign selected entities to group 
[Hide all) 

[Show all) 


▼ Scene View Settings Game View 


a 

FPS: 58.780 - inactive wir 



Info (4) Warning (0) Error (0) 



Could not load metadata 

Loading universe universes/player. unv. . . 

Parsing universe... 

Universe parsed in 0.0084615984 seconds 


O GifCa... - X 

N 


Stop 


Frame 


LumixEngine 
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That's all folks 


- Don't shy away from creating your own 

- Standalone tools 

- In-game "always available" tools 

- Unity editor extensions, etc. 

- Beware letting your design/dev process be too 
enslaved by what's readily available. 

- Productivity or innovation often requires off- 
the-road work. 
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Contact, Links 


Q @ocornut 

omar@miracleworld.net 


Dear ImGui http://www.github.com/ocornut/imaui 

Become my patron on , , , 

(g) pafrreon http://www.patreon.com/imaui 
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